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package server; 

import java.io.*; 

// User Configuration Information, 
public class Userinfo 

{ 

public Profile. jp; 

public ^Screening sc; 
g settings. " 

public Opti ons o; 
le options 

public MACAddr__^ ma; 
ddress. 

public Fo rwarding lnfo fi; 
o ' k 



nfo. 



public static Userinfo 



uiNull 



new UserlnfoO ; 



// User profile. 
// Call screenin-i 

// User-selectab-» 

// Assigned MACA-» 

// Forwardinglnfo 

// Initial UserI-» 



public Userinfo (Profile p, Screening sc, Options o, MACAddr ma, Forwardinglnfo fi) 

{ 

this.p = p; 

this.sc = sc; 

this .o . = o; 

this. ma = ma; 

this.fi = fi; 

} 

public Userinfo (Profile p, Screening sc, Options o, MACAddr ma) 



{ 



this(p, sc, o, ma, new Forwardinglnfo ()) ; 



// Default Userinfo. 

public Userinfo (ServerConfig scon) 

{ 

this (new Prof ile (scon) , new Screening (), new Options (scon) , new MACAddr (), new F 
orwardinglnf o(scon) ) ; 

} 



public Userinfo (ServerConfig scon, MACAddr ma) 

{ 

this (new Prof ile (scon) , new Screening (), new Options (scon) , ma, new Forwardingln 
fo(scon) ) ; 

} 

public Userinfo (ServerConfig scon, MACAddr ma, String sAltSpoken) 

{ 

this (new Prof ile (scon, sAltSpoken) , new Screening (), new Options (scon) , ma, new 
Forwardinglnfo (scon) ) ; 

} 

public Userinfo (ServerConfig scon, String sAltSpoken, String sFirst, String sLast) 

{ 

this(new Prof ile (scon, sAltSpoken, sFirst, sLast) , new ScreeningO, new Options( 
scon) , new MACAddr () , new Forwardinglnfo (scon) ) ; 

} 
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public UserInfo(ServerConf ig scon, String sAltSpoken, String sFirst, String sLast, S 
tring sldent Phrase) 

{ 

this (new Prof ile (scon, sAltSpoken, sFirst, sLast, sldentPhrase) , new ScreeningO 
, new Options (scon) , new MACAddr ( ) , new Forwardinglnf o (scon) ) ; 

} 

public UserInfo(ServerConf ig scon, String sEMail, MACAddr ma, String sAltSpoken) 

this (new Profile (scon, sEMail, sAltSpoken), new ScreeningO, new Options (scon) , 
ma, new Forwardinglnf o (scon) ) ; 

} 

public UserInfo(UserInfo ui) 
{ 

p = ui.p.copyO; 

sc = ui . sc . copy ( ) ; 

o = ui.o.copyO; 

ma = ui . ma ; 

f i = ui.fi. copy ( ) ; 

} 

public UserlnfoO 

{ 

this(new Profile () , new ScreeningO, new OptionsO, new MACAddrO, new Forwardin 
glnfoO) ; 

} 



public Userlnfo copy() 

{ 

return new Userlnfo (this) ; 

} 



public MACAddr getMACAddrO 
{ 

return ma; 

} 



public Forwardinglnf o get Forwardinglnf o () 



return fi; 

} 



// Writes Userlnfo to a stream. 



public void write (DataOutputStream s) throws IOException 

{ 

p. write (s) ; 
sc .write (s) ; 
o. write (s) ; 
ma. write (s) ; 
f i .write (s) ; 

} 



// Reads Userlnfo from a stream. 



public static Userlnfo read (Datalnput St ream s) throws IOException 
Userlnfo ui = new UserlnfoO; 



ui.p = Prof ile. read (s) ; 
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ui.sc : 

Ui .O = 

ui.ma = 
ui.fi : 
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Screening. read (s) ; 
Options. read (s) ; 
MACAddr.read(s) ; 
Forwardinglnfo.read(s) ; 



} 



return ui; 



public void merge (Userlnfo uiOld, Userlnfo uiBase) 

{ 

(new Merger ()) .merge (this, uiOld, uiBase); 




// Profile info, 
public static cl 

{ 

// Permission^ 



public final static int pmLocAdmin 
dministrator permissions. 

public final static int pmGroupJoin 
roup join. 

public final static int pmGroupManage 
roup management . 

public final static int pmCalllntemal 
nternal calls. 

public final static int pmCallExternal 
xternal calls. 

public final static int pmVIP 
IP call status. 

public final static int pmLocate 
ermission to locate users. 

public final static int pmLogin 
ermission to log in. 

public final static int pmDefault 
efault permissions. 

public String sLoq i n ; 
og-in name (could be same as e-mail address) . 
public String 

as sword. 

public String 
ast name . 

public String 
irst name. 

public StringSet 
lternative spoken names. 

public String 
dentifying phrase. 

public String 
-mail address. 

public String 
ork phone no (or extension) . 

public String 
ell phone no. 

public String 
ome phone no. 

public int 
ermission bit vector. 

public String 
in code for outside calls. 

public String 




0x1; 
0x2 ; 
0x4; 
0x8; 
0x10 
0x20 
0x40 
0x80 
OxDE 



// A-i 
// G-« 
// G-» 
// I- 
// E-i 
// V- 
// P- 
// P- 
/ / D-i 

// L- 
// P- 
// 

// F- 
// A- 
// I- 
// E- 
// W- 
// C- 
// H- 
// P- 
// P- 

// o- 
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wing user for a personal contact. 

public Profile () 

{ 



5 



sLogin 

sPassword 

sLast 

sFirst 

ssAlt Spoken 

sldentPhrase 

sEMail 

sWorkPhone 

sCellPhone 

sHomePhone 

iPermissions 

SPIN 

sOwner 



n n 

n n 

11 ii 

tj n 



new StringSetO; 



n n 

ii n 

n ii 

n n 



pmDefault ; 



n n 
n ti 



public Profile (int iDef ault Permissions) 
this(); 



this . iPermissions 



iDefaultPermissions; 



public Prof ile (Server Config scon) 
this(); 
iPermissions 



} 



scon. getDef ault Permissions () 



// Copy constructor, 
public Prof ile (Prof ile p) 

{ 

s Log in 

sPassword = 
sLast = 
sFirst 
ssAltSpoken 
. sldentPhrase 
sEMail 
sWorkPhone 
sCellPhone 
sHome Phone = 
iPermissions = 
SPIN 
s Owner 



} 



p. sLogin; 
p. sPassword; 
p. sLast ; 
p. sFirst ; 

p . ssAltSpoken . copy ( ) ; 
p . s Iden t Phrase ; 
p. sEMail; 
p . sWorkPhone ; 
p. sCellPhone; 
p . sHomePhone ; 
p. iPermissions ; 
p. SPIN; 
p. sOwner ; 



public Prof ile (ServerConf ig scon, String sAltSpoken) 
this (scon) ; 



} 



if ( !sAltSpoken. equals ( n " ) ) 

ssAltSpoken. add (sAltSpoken) ; 



// Temporary constructor for test purposes. 



(0)); 
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public Prof ile(ServerConfig scon, String sAltSpoken, String sFirst, String sLast-. 

{ 

this(scon, sAltSpoken, sFirst, sLast, nn ); 

public Profile (ServerConfig scon, String sAltSpoken, String sFirst, String sLast-. 
, String sldent Phrase) 

{ 

this (scon) ; 

this. sFirst = sFirst; 

this.sLast = sLast; 

this. sldentPhrase = sldentPhrase; 

sliogin = makeLog in (s First , sLast) ; 

sEMail = sLogin + " ©voce ra . com" ; 

if (! sAl tSpoken. equal s(»") ) 

ssAltSpoken . add (sAltSpoken) ; 

} 

// Temporary, for dinking up a login name. 

private String makeLogin (String sFirst, String sLast) 

String sFirstLetter = sFirst . equals ("" ) ? "» : ( n » + sFirst . charAt-^ 

return (sFirstLetter + sLast ) . toLowerCase ( ) ; 

public Prof ile( ServerConfig scon, String sEmail, String sAltSpoken) 
this (scon) ; 

this.sEMail = sEmail; 

if (I sAltSpoken . equals ( " " ) ) 

ssAltSpoken. add (sAltSpoken) ; 

public Profile copy() 

return new Prof ile (this) ; 

} 

// Returns set of spoken pronunciations. 

public StringSet getSpokenNames ( ) 

StringSet ss = new StringSet () ; 

String sSpokenName = getSpokenName ( ) ; 

if (! sSpokenName. equals ( H n ) ) 

ss. add (getSpokenName () ) ; / / A-. 

dd primary spoken name. 

ss . add (ssAltSpoken) ; 

if (sldentPhrase. length () > 0) 
ss. add (sldentPhrase) ; 

return ss; 
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} 

// Returns primary spoken name, 
public String getSpokenName ( ) 

{ 

if (sFirst. equals ("")) 

return sLast . toLowerCase () ; 

if (sLast. equal s( ,? ") ) 

return sFirst . toLowerCase () ; 

return sFirst . toLowerCase ( ) + " n + sLast . toLowerCase () ; 



// Returns set of allowed spellings. 

public StringSet getSpelledNames () 
{ 

StringSet ss = new StringSet (); 

if (sLast. length () > 0) 
ss.add(sLast) ; 

return ss; 

} 

// Returns true if has permissions given by iMask. 
public boolean hasPermissions (int iMask) 

{ 

return (iMask & iPermissions) == iMask; 



// Enables or disables permissions associated with given mask; 

public void setPermissions (int iMask, boolean bEnable) 

if (bEnable) 

iPermissions |= iMask; 

else 

iPermissions &= -iMask; 

} 

// Returns true for a personal contact, 
public boolean isPersonal() 

{ 

return sOwner. length () > 0; 



// Writes profile out to a streasm. 

public void write (DataOutput St ream s) throws IOException 

s.writeUTF (sLogin) ; 
s.writeUTF(sPassword) ; 
s.writeUTF(sLast) ; 
s.writeUTF (sFirst) ; 
ssAltSpoken. write (s) ; 
s.writeUTF (sldent Phrase) ; 
s.writeUTF (sEMail) ; 
s . wr i teUTF ( sWorkPhone ) ; 
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s.writeUTF(sCellPhone) ; 
. s . wri teUTF ( sHomePhone ) ; 
s.writelnt (iPermissions) ; 
s.writeUTF(sPIN) ; 
s.writeUTF(sOwner) ; 



public static Profile read (DatalnputStream s) throws IOException 
Profile p = new ProfileO; 



p.sLogin 

p.sPassword 

p. sLast 

p.sFirst 

p. ssAlt Spoken 

p. sldent Phrase 

p.sEMail 

p . sWorkPhone 

p.sCe 11 Phone 

p . sHomePhone 

p. iPermissions 

p. SPIN 

p.sOwner 



s . readUTF ( ] 
s . readUTF ( ] 
s . readUTF ( ] 
s . readUTF ( ] 
StringSet . read ( s ) ; 
s . readUTF ( ] 
s . readUTF ( ] 
s . readUTF ( ] 
s . readUTF ( ] 
s . readUTF ( ) 
s.readlnt {) 
s . readUTF ( ] 
s.readUTF(] 



return p; 



} 



// Screening information. 

public static class Screening 

// Call Screening Settings. 

public final static int 
public final static int 

public int 
// Currently- selected setting. 

public BuddySet 
// Set of buddies. 

public StringSet 



cscBlockAll 
cscAllowAll 

iCallScreening; 

bsBuddies; 

ssExceptions; 



0; 
l; 



public Screening (int iCallScreening, BuddySet bsBuddies, StringSet ssExceptions) 

this. iCallScreening = iCallScreening; 

this. bsBuddies = bsBuddies; 

this . ssExceptions = ssExceptions; 

public Screening (Screening sc) 

iCallScreening = sc . iCallScreening; 

bsBuddies = sc . bsBuddies . copy ( ) ; 

ssExceptions = sc . ssExceptions . copy ( ) ; 



public Screening () 

this(cscAllowAll, new BuddySet () , new StringSet ()) ; 
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} 

public Screening copy() 

return new Screening (this) ; 

// Returns true if sUserName is the user name of a buddy, either directly or as 
a member of a group. 

public boolean isBuddy (Server s, String sUserName) 

return Entity .getEntities (s, bsBuddies . getNames () ) .expandO .getNamesO .conta 
ins (sUserName) ; 

} 

// Returns true if sName is the entity name of a buddy, not indirectly as a memb 
er of a group. 

public boolean isImmediateBuddy (String sName) 
return bsBuddies . findName (sName) != -1; 

// Returns true if sName is the entity name of a screening exception, not indire 
ctly as a member of a group. 

public boolean isImmediateExcept ion (String sName) 
return s sExcept ions . find (sName) != -1; 

// Returns true if sUserName is the user name of a buddy with VIP status, 
public boolean isVIPBuddy (Server s, String sUserName) 
return bsBuddies . isVIPBuddy ( s , sUserName) ; 

// Returns true if currently blocking calls from party with given name, 
public boolean isBlocked (Server s, String sName) 

return (iCallScreening « cscBlockAll) A isException(s, sName) ; 

// Returns true if sName is an exception, either directly or as a member of an e 
xception group. 

private boolean isExcept ion (Server s, String sName) 



e); 



return Entity .getEntities (s , ssExceptions) . expand () .getNamesO . contains (sNam 

} 

// Returns true if this is equal to given Screening. 

public boolean isEqual (Screening sc) 

if (iCallScreening != sc . iCallScreening) 
return false; 

if ( ! bsBuddies . getNames ( ) . i sEqual ( sc . bsBuddies . getNames ( ) ) ) 
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return false; 

if ( IssExceptions.isEqual (sc . ssExceptions) ) 
return false; 

return true; 

} 

// Updates Screening information according to given parameters. 

public void update (boolean bBlock, boolean bOnly, boolean bExcept, boolean bBudd-^ 
ies, StringSet ssUsers) 

{ 

if (bBlock) 

block(bOnly, bExcept, bBuddies, ssUsers); 

else 

allow(bOnly, bExcept, bBuddies, ssUsers) ; 
private void block (boolean bOnly, boolean bExcept, boolean bBuddies, StringSet s-. 

sUsers) 

{ 

if (bOnly) // Block only case. 

set Screening ( cscAl lowAll ) ; 
if (bBuddies) 

addBlock (bsBuddies . getNames ( ) ) ; 
addBlock ( ssUsers) ; 

} 

else 

if (bExcept) // Block all except case. 

setScreening(cscBlockAll) ; 
addAl low (ssUsers) ; 

} 

else 

if (! bBuddies && ssUsers. size () .== 0) 
setScreening (cscBlockAll) ; 

else 

{ 

if (bBuddies) 

addBlock (bsBuddies . getNames ( ) ) ; 
addBlock ( ssUsers ) ; 

} 

} 

private void allow (boolean bOnly, boolean bExcept, boolean bBuddies, StringSet s-> 

sUsers) 

{ 

if (bOnly) 

block(false, true, bBuddies, ssUsers); 

else 

if (bExcept) 

block(true, false, bBuddies, ssUsers); 

else 

if (! bBuddies && ssUsers . size () == 0) 
setScreening(cscAllowAll) ; 

else 

{ 

if (bBuddies) 

addAl low (bsBuddies. getNames () ) ; 
addAl low (ssUsers) ; 

} 
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} 

private void set Screening (int iCallScreening) 

this. iCallScreening = iCallScreening; 

ssExceptions . empty ( ) ; 

} 

// Incrementally blocks ssUsers. 

private void addBlock (StringSet ssUsers) 

switch (iCallScreening) 

case cscBlockAll: 

ssExceptions . remove (ssUsers) ; 
break ; 

case cscAllowAll: 

ssExceptions. add (ssUsers) ; 
break; 



default : 

Debug. fail () ; 



// Incrementally allows ssUsers. 

private void addAllow (StringSet ssUsers) 

switch (iCallScreening) 

case cscBlockAll: 

ssExceptions. add (ssUsers) ; 
break; 

case cscAllowAll: 

ssExceptions . remove (ssUsers) ; 
break ; 

default : 

Debug. fail () ; 

> 1 

public void write (Da taOutputSt ream s)' throws IOException 

s.writelnt (iCallScreening) ; 
bsBuddies. write (s) ; 
ssExceptions. write (s ) ; 

public static Screening read (DatalnputStream s) throws IOException 

Screening sc = new Screening ( ) ; 

sc . iCallScreening = s . readlnt ( ) ; 

sc. bsBuddies = BuddySet . read (s) ; 

sc. ssExceptions = StringSet . read (s) ; 

return sc; 
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} 

// User-selectable options, 
public static class Options 

{ 

// Boolean options bitmasks. 

// NOTE: Do not change these without changing boDefault in b\se.h. 



// None. 



public final static int 
public final static int 



// True if caller's name is to be spoken. 



boNone 



boVerbalCal lAnnouncement 



public final static int 



boVerbalGenieGreeting 



// True if genie is announced verbally 

public final static int 
// True if genie is announced by- 
public final static int 
// Auto-answer option. 

public final static int 
// Auto-who called option. 

public final static int 
// Audible alert on out -of -range 

public final static int 
// Audible alert on battery low. 

public final static int 
// Clears badge assignment upon on charger detect. 

public final static int boTour 
// True if currently in access point tour mode. 

public final static int boLostBadgeFinder 
// True if currently in "lost badge finder" mode. 

public final static int boVMessageAlert 
// Audible alert on text message waiting. 

public final static int boTMessageAlert 
// Audible alert on voice message waiting. 

public final static int boDisableAlertsInDND 
// True if should disable alerts when in DND mode. 



boTonalGenieGreeting 
a tone. 

boAutoAnswer 

boAu t oWhoCa 1 1 ed 

boOutOf RangeAlert 

boLowBatteryAlert 

boAutoLogOut 



0x0; 
0x1; 
0x2; 
0x4; 
0x8; 
0x10; 
0x20; 
0x40; 
0x80; 
0x100; 
0x200; 
0x400; 
0x800; 
0x1000; 



// NOTE: Do not change this without changing boDefault in b\se.h. 

public final static int boDefault = 0xC5F; 

// Everything but AutoLogout/Tour/Badgef inder/OutOf Range /DisAlertsDND 

public final static String sDef aultRingTone = " Ring- Tone - 1 " 

public final static String sDefault Persona = "Jean"; 



public int 

// Boolean options bit vector. 

public String 
// Ring tone choice. 

public String 
// Genie personality options. 



iOptions; 
sRingTone; 
sGeniePersona ; 



public Options (int iOptions, String sRingTone, String sGeniePersona) 

this. iOptions = iOptions; 

this . sRingTone = sRingTone; 

this. sGeniePersona = sGeniePersona; 

} 



public Options () 

{ 

this(0, "", ""); 
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public Options (Options o) 



iOptions 

sRingTone 

sGeniePersona 



o. iOptions ; 

o. sRingTone ; 

o. sGeniePersona; 



// Default options constructor. 



public Options (ServerConfig scon) 



iOptions 

sRingTone 

sGeniePersona 



scon.getDef aultOptions () ; 
scon.getDefaultRingTone () ; 
scon. getDefault Persona () ; 



public Options copy() 

{ 




// Returns true if all options in iMask are set. 
public boolean hasOpt ions (int iMask) 

return (iOptions & iMask) == iMask; 

// Sets/Resets given options. 

public void setOpt ions (int iMask, boolean bSet) 
if (bSet) 



// Writes options out to a stream. 

public void write (DataOutputStream s) throws IOException 

s.writelnt (iOptions) ; 

s.writeUTF (sRingTone) ; 

s . writ eUTF( sGeniePersona) ; 

public static Options read (DatalnputStream s) throws , IOException 

Options o = new Options () ; 

o. iOptions = s.readlntO; 

o. sRingTone = s.readUTFO ; 

o . sGeniePersona = s . readUTF ( ) ; 

return o; 



iOptions 



| = iMask ; 



else 



iOptions 



&= -iMask; 
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public static class Forwarding I nf o 

{ 

public final static int 
// No forwarding. 

public final static int 
// Forward to desk phone. 

public final static int 
// Forward to cell phone. 

public final static. int 
// Forward to home phone. 

public final static int 
// Forward to voice mail. 

public final static int 
// Forward to other phone number. 

public final static int 
// Forward to another badge. 

// When to forward option. 



foNone 



foDeskPhone 



foCe 11 Phone 



foHomePhone 



f oVoiceMail 



foOtherPhone 



f oBadge 



public final static int fwNever 
// Applies only if foNone selected. 

public final static int fwOffline 
Forward if user is not logged in or not on network. 

public final static int fwBusy 
Forward if user is currently busy with another call. 

public final static int fwRefused 
Forward if call is blocked or refused. 

public final static int fwAlways 
// Always forward, even if user is available. 



// 
// 
// 



0x0 
0x1 
0x2 
0x4 
0x8 



public final static int 



{ 



fwDe fault [] 



}; 



f wNever, 
fwOffline, 
fwOffline, 
fwOffline, 

fwOffline | fwBusy | fwRefused, 
fwOffline, . 

fwOffline | fwBusy | fwRefused 



public int 
// One of forwarding types above. 

public String 
// Forwarding phone no for foPhone. 

public String 
// Forwarding entity for foBadge. 

public int [] 
// When to forward for each option. 



i Forwarding; 
sForwardingNo ; 
sForwardingName ; 
i Forwa rdWhen ; 



public ForwardinglnfoO 

{ 

this(foNone, n ", n ", fwDefault) ; 

public ForwardingInfo(int iForwarding, String sForwardingNo, String sForwardingN- 
ame, int[] i Forwa rdWhen) 

{ 

this. iForwarding = iForwarding; 

this. sForwardingNo = sForwardingNo ; 

this . sForwardingName = sForwardingName ; 

this. iForwardWhen = iForwardWhen; 
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} 

// Copy constructor. 

public Forwardinglnf o (Forwardinglnf o fi) 

{ 

iForwarding = f i . iForwarding; 

sForwardingNo = f i . sForwardingNo; 

sForwardingName = fi . sForwardingName; 

iForwardWhen = new int [fwDefault . length] ; 

for (int i = 0; i < iForwardWhen. length; ++i) 

iForwardWhen [i] = fi. iForwardWhen [i] ; 

} 

// Default forwarding constructor, 
public Forwardinglnf o(ServerConf ig scon) 
this(); 



public Forwardinglnf o copyO 

return new Forwardinglnf o( this) ; 



public boolean equals (Object o) 

return (o instanceof Forwardinglnf o) isEqual ( (Forwardinglnf o) o) ; 



public boolean isEqual (Forwardinglnf o fi) 

if (iForwarding != fi . iForwarding) 
return false; 

if ( ! sForwardingNo. equals (fi. sForwardingNo) ) 
return false; 

if ( ! sForwardingName . equals (f i . sForwardingName) ) 
return false; 

for (int. i = 0; i < iForwardWhen. length; ++i) 

{ 

if (iForwardWhen [i] != fi . iForwardWhen [i] ) 
return false; 

} 

return true; 

} 

// Writes this to a stream. 

• public void write (Da taOutput St ream s) throws IOException 

s.writelnt (iForwarding) ; 
s.writeUTF( sForwardingNo) ; 
s.writeUTF( sForwardingName) ; 
writelntArray (s, iForwardWhen) ; 
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private static void writelntArray (DataOutputStream s, int[] ia) throws IOExcepti-i 

on 

{ 

s.writelnt (ia. length) ; 

for (int i = 0; i < ia. length; ++i) 
s.writelnt (ia [i] ) ; 

} 

// Reads in from a stream. 



public static Forwarding Info read (DatalnputStream s) throws IOException 

{ 

int i Forwarding = s . readlnt ( ) ; 

String sForwardingNo = s . readUTF ( ) ; 

String sForwardingName = s. readUTF (); 

int[] iForwardWhen = readlntArray (s) ; 

return new Forwardinglnf o (iForwarding, sForwardingNo , sForwardingName, iForw-» 

ardWhen) ; 

} 

private static int [] readlntArray (DatalnputStream s) throws IOException 

{ 

int[] ia = new int [s . readlnt ()] ; 

for (int i = 0; i < ia. length; ++i) 
ia[i] = s. readlnt (); 



return ia; 



// Three-way merger. 

private static class Merger extends ThreeWayMerger 
static String sBitVectors [] = 

{ 

"iOptions", "iPermissions" 

}; 

public Merger () 

{ 

super (sBitVectors) ; 

} 



protected boolean isAtomic (Class c) 

{ 

return super . isAtomic (c) | | c == Forwardinglnf o. class | | c == BuddySet . class-* 

} 



